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1.1.1 


NUMBER: 78 

NAME: SAIR 

FUNCTION: Arm/Disarm Software Interrupts 

STATUS : User 

CALLING SEQUENCE: LDA M 

BRS 78 

M is the complete new interrupt mask. 

DESCRIPTION: The new Interrupt mask is substituted for 
the old one. A user may arm interrupts 1-10. An exec 
fork may arm interrupt 11 also. Interrupt 1 is in bit 
4 , of the mask word. The interrupts are as follows: 

1 Interrupt if Program Panic (BRS 10 or Escape) 

2 Interrupt if Memory Panic' 

3 Interrupt if Lower Pork terminates 

^ Interrupt if any I/O condition occurs which 
sets a flag bit (0,7 or 8 in file number word) 
11 Interrupt if DSU error 

5 through 10 interrupts on condition set by user 

Location 200 octal plus the interrupt number must be 
set to point to a routine to process the interrupt. 
When the interrupt occurs an SBRM* is executed to the 
location pointed to. If it is desired to return to the 
point in the program interrupted , the user must BRR to 
the location where the return was saved. 

Example : 

SET INTERRUPT ROUTINE RETURN 
LDA =ESCAPE ESCAPE ZRO ESCRTW BRR ESC RTN 
STA 201B . 


REGISTERS AFFECTED: None 


1.1.2 


NUMBER: 79 

NAME: SIIR 

FUNCTION: Cause Interrupt 

STATUS: User 

CALLING SEQUENCE: LDA N 

BRS 79 

N = Interrupt number. N has the range of 5 to 10 

DESCRIPTION: Parallel forks in the structure are 
searched first and then higher forks. The interrupt 
will be caused in the first fork found which has the 
interrupt armed. If no fork has the interrupt armed, 
it is treated like a NOP. This would normally be used 
to cause interrupts 5 through 10 to interrupt. 

REGISTERS AFFECTED: None 


1.1.3 


NUMBER: 49 

NAME: SRIR 

FUNCTION: Read Interrupts Armed 

STATUS: User 

CALLING SEQUENCE: BRS M9 

DESCRIPTION: Reads the Interrupt mask into the A regis- 
ter. Bit 4 corresponds to interrupt number 1, 5 to num- 
ber 2 and etc. There are 11 programmable interrupts. 
See also BRS 78 (1.1.1). 

REGISTERS AFFECTED: A 


1.1.4 


NUMBER: BE+12 

NAME: TIMINT 

FUNCTION: Interrupts a fork after a specified period 
of time. 

STATUS: User 

CALLING SEQUENCE: LDA M 

LDB T 
LDX N 
BRS BE+12 
NORMAL RETURN 

M is the new interrupt mask. 

T is the time in milliseconds after which the fork 

will be interrupted. 
N is the interrupt number. 

DESCRIPTION: The fork issuing this BRS will be inter- 
rupted after the delay if the interrupt specified by 
N is armed at that time. (Exception: The interrupt 
will be ignored if the fork is dismissed on a BRS 9 (I.3.I) 
at the time of the interrupt.) If a fork gives this 
BRS again with the same N before the time has passed, 
the new time will be set. A fork may have a maximum 
of three timing interrupts pending simultaneously. See 
also, BRS 81 (1.5.3). 

REGISTERS AFFECTED: None 


1.2.1 


NUMBER: 90 

NAME: DPR 

FUNCTION: Declare a Pork for "Escape" 

STATUS: User 

CALLING SEQUENCE: BRS 90 

DESCRIPTION: In case the user types "Escape" or a fork 
panics, this fork will be activated. A fork panic is 
a fork status of 0, 1, or 2. See also, BRS 10 (1.6.1). 

REGISTERS AFFECTED: None 


1.2.2 


NUMBER: ^6 

NAME; NROUT 

FUNCTION: Turn Escape Off 

STATUS: System 

CALLING SEQUENCE: BRS 46 

DESCRIPTION: This BRS will set up to remember an escape 
interrupt, but not allow the program to be interrupted. 
It will stack the first escape occurring and ignore 
any subsequent ones. 

A program running with escape turned off cannot be ter- 
minated by a higher fork. 

See also, BRS 26 (1.2.^1) and 4? (1.2 .3) . 

registers: AFFECTED: None 


1.2.3 


NUMBER: 4? 

NAME; SROUT 

FUNCTION: Turn Escape On 

STATUS: System 

CALLING SEQUENCE: BRS 4? 

DESCRIPTION: This BRS reverses BRS 46 (1.2.2); that 
is, reactivates the escape Interrupt. If an escape in- 
terrupt was stacked (remembered) while in an Off condi- 
tion, the interrupt will occur. 

REGISEERS AFFECTED: None 


1.2.i| 


NUMBER: 26 

NAME : SKROUT 

FUNCTION: Skip if Escape Waiting 

STATUS: System 

CALLING SEQUENCE: BRS 26 

EXCEPTION RETURN 
NORMAL RETURN 

DESCRIPTION: Checks for a stacked escape for this 
program and if there is one, transfers control to the 
"normal return" or to the "exception return" if there 
is not an escape stacked. Significant only after BRS 
i|6 (1.2.2). 

REGISTERS AFFECTED: None 


1.3.1 


NUMBER: 9 

NAME: PKST 

FUNCTION: Open Fork 

STATUS: User 

CALLING SEQUENCE : LDA T 

BRS 9 

. T = Address of a "Panic Table" 
Bits through ^ of register A have the following 
significance: 

= Make fork system if current fork is system. 

1 = Set fork relabeling from panic table. 

Otherwise use current relabeling. 

2 = Propogate escape assignment to fork (See 

BRS 90, 1.2.1). 

3 = Make fork fixed memory. It is not allowed 

any more memory than it started with. 
H = Make fork local memory. New memory will 

be assigned to it independent of the con-iri 

trolling fork. 
5 = Make fork privileged if current fork is 

privileged. 

DESCRIPTION: BRS 9 is used to create dependent entries 
in the PAC table. The panic table indicated by register 
A must not be the same for two forks of the same fork 
or overlap a page boundary; if it is, BRS 9 is illegal. 
BRS 9 creates a new fork as a fork of the fork creating 
it, which is called the controlling fork. The fork is 
lower in the hierarchy of forks than the controlling 
fork. The controlling fork may itself be a fork of some 
still higher. fork. For more detailed information see 
Document No. 30.10.31* 

When BRS 9 is executed by a user fork, the user fork 
is dismissed until the lower fork terminates. This has 
the same effect as issuing a BRS 31 (1.5.^) immediately 
after a BRS 9. A user may not have more than eight forks 
in his fork structure. This includes the system fork 
and one fork for each system BRS that is active. Only 
one system BRS can be active. 

REGISTERS AFFECTED: None. 


1.3r2 


NUMBER: 57 

NAME: CQO 

FUNCTION: Guarantee l6ms Computing 

STATUS: User 

CALLING SEQUENCE:; BRS 57 

DESCRIPTION: This BRS guarantees to the user upon re- 
turn at least 16 msec, of uninterrupted computation. 
This is done by dismissing the user If less than 16 
msec . remain in his time quantum. 

This time will include some system overhead. Thus, 

if the time required, is very close to 16 msec, a BRS 

^5 (1.5.1) should be used. BRS ^5 guarantees several 
times this amount. 

REGISTERS AFFECTED: None 


1.4.1 


NUMBER: 30 

NAME: FKRD 

FUNCTION: Read Pork 

STATUS: User . 

CALLING SEQUENCE: LDA P 

BRS 30 

P = Panic Table Address 

DESCRIPTION: Reads the current status of a lower fork 
into the panic table indicated by the A register. It 
does not influence the operation of the fork in any 
way. 

REGISTERS AFFECTED: None 


1.4.2 


NUMBER: 107 

NAME: PKRA 

FUNCTION: Read All Pork Statuses 

STATUS: User 

CALLING SEQUENCE: BRS 107 

DESCRIPTION: The status of all lower forks is recorded 
In the appropriate panic tables. 

REGISTERS AFFECTED : None 


1.5.1 


NUMBER: ^5 

NAME: SQO 

FUNCTION: Dismitss oh Quantum Overflow 

STATUS:. User 

CAL-ING SEQUENCE : BRS" 7*5 

DESCRIPTION: This BRS causes the user to be dismissed 
as though he had overflowed his quantum. It guarantees 
that the nort time he is started he will have a complete 
short time quantum. See BRS 57 (1.3.2) to guarantee 
l6-',msec,. ..: , 

REGISTERS AFFECTED: None 


1.5.2 
Rev. 8/67 


NUMBER: 72 

NAME: EXDMS 

FUNCTION: System Fork Dismissal 


CALLING SEQUENCE : 

LDB 

D 


LDX 

N 


BRS 

72 


N = The number of the queue that the fork is to be 

put on. 
D = Dismiss condition. 

DESCRIPTION: Dismisses a system fork and puts it on 
the specified queue. Returns, to call +1 v?hen recalled. 

= Teletype queue 

1 -I/O queue 

2 = Short time quantum queue 

3 = Long time quantum queue 

REGISTERS AFFECTED: None 


1.5.3 


NUMBER:, 8l 

NAME: WREAL ^ 

FUNCTION: Dismiss for Specified Amount of Time, 

STATUS: User 

CALLING SEQUENCE: LDA T 

BRS 81 

T = Dismissal time in milliseconds . 

DESCRIPTION: The fork is dismissed for the number of 
milliseconds specified in A. See also, BE+12 (1.1.^) 

REGISTERS AFFECTED: A 


1.5.^ 


NUMBER: 3I 

NAME: FKWT 

FUNCTION: Wait for Fork to Cause a Panic 

STATUS: User 

CALLING SEQUENCE: LDA P 

BRS 31 

P = Panic Table Address 

DESCRIPTION: Causes the controlling fork to be dismissed 
until the lower fork, or forks, causes a panic. When 
it does, the controlling fork is reactivated at the in- 
struction following this BRS, and the panic table con- 
tains the status of the fork on its dismissal. The 
status is also put into the X register. The panic table 
address is put into the A register. 

The controlling fork must have armed an interrupt or 
a lower fork must execute a BRS 10 (1.6.1) . 

REGISTERS AFFECTED: X,.A 


1.5.5 


NUMBER: 106 

NAME : PKWA 

FUNCTION: V/ait for Any Pork to Terminate 

STATUS: User 

CALLING SEQUENCE: BRS 106 

DESCFilPTION: Pork is dismissed until some lower fork 
terminates. Whan a lower fork terminates, the panic 
table address will be left in A. 

REGISTERS AFFECTED: None 


1.5.6 


NUMBER: 109 

NAME: DMS 

FUNCTION: Dismiss 

STATUS: User 

CALLING SEQUENCE: BRS 109 

DESCRIPTION: The fork is dismissed. It can only be 
activated again by a program interrupt which has been 
armed by this fork or the termination of a lower fork 

REGISTERS AFFECTED: None 


1.6.1 


NUMBER: 10 

NAME: PPAN 

FUNCTION: Programmed Panic. Terminates a Fork. 

STAT j3; User ■ 

CALLING SEQUENCE: BRS 10 

BRS 10 terminates the fork that issues it and re- 
turns control to the higher fork.- It is just like 
tipping "escape" on the teletype. 

DEtiCRIPTION: Terminates a lower fork. This condition 
can be distinguished from a panic caused by the escape 
key. only by the fact that in the former case the program 
counter in the panic table points to a word containing 
BRS 10. This BRS v:ould normally be used to terminate 
a fork when it is finished. The information in the 
panic table would 3 therefore, only be useful to a higher 
fork or to this fork only if interrupt 4 has been armed 
by this fork. 

RFGISTERS AFFECTED: None 


1.6.3 


NUMBER: 32 

NAME: PKTM 

FUNCTION: Terminate a Pork 

STATUS: User 

CALLING SEQUENCE: LDA P 

BRS 32 

P = Panic Table 

DESCRIPTION: Causes a lower fork to be unconditionally 
terminated and its status to be stored into the panic 
table. The X register contains the status word upon 
return. 


REGISTERS AFFECTED: 


1.6.^ 


NUMBER: 73 

NAME: EPPAN 

FUNCTION: Economy Panic 

STATUS: User 

CALLING SEQUENCE: LDA N 

BRS 73 

N = Number of forks to terminate. 

DESCRIPTION: This is like doing a BRS 10 for each of 
the forks specified. Porks are terminated going up 
until the system fork is reached or until N forks have 
been terminated. 

REGISTERS APPE€TED: None 


1.6.5. 


NUMBER: 108 

NAME: FKTA 

FUNCTION: Terminates All Porks 

STATUS: User 

CALLING SEQUENCE : BRS 108 

DESCRIPTION: All lower forks are terminated and their 
status read into the corresponding panic tables, 

REGISTERS AFFECTED: None 


2.1.1 


NUMBER : 1 

NAME: , MONOPN 

FUNCTION: Open a Pile of a Specific Device 

STATUS: System 

CALLING SEQUENCE: LDA +1 

LDX D , . 

BRS 1 ■ 
EXCEPTION RETURN 
NORMAL RETURN 

Pile number' will be in register A on Normal Return. 

I - The relative address (DSU Address MOD 4) of 
the file's Index Block for DSU files, or unit 
number for magnetic tape, otherwise anything. 

~ - Make the file read only. 

-!- - Make the file read/write. 

D - Device number. 

Available device numbers are as follows: 

1. Paper tape input. 

2. Paper tape output 

3 . Card input , 

H. Magnetic tape input. 

5- Magnetic tape output. 

7. Printer. 

8. Sequential. DSU input 

9. Sequential DSU output. 
10. Random DSU 

DESCRIPTION:. The "open file" BRS is used to condition 
a file for input or output processing. If the file is 
successfully opened, control is transferred to the nor- 
mal return; otherwise control is transferred to the ex- 
ception return. Exception conditions are as follows: 

1. Device in use or not available. 

2 . File in use . 

A file jfiay be opened for input any number of times for 
the purpose of multiple user access or multiple proces- 
sing by a single user. A file that is opened for out- 
put cannot be ooened again until it is closed. See also, 
BRS's: 2, 3, 20, 82. 

REGIST::^:1S AFFECTED: A,X 


2.1.2 


NUMBER: ilO 

NAME: RDU 

FUNCTION: Read Device and Unit 

STATUS: User 

CALLING SEQUENCE: LDA -PILE No. 

BRS 110 
NORMAL RETURN 

DESCRIPTION: Output X = device number. 

A = Unit number. 
See BRS 1 (2.1.1) for device number description. 

REGISTERS APPECTED: A,X 


2,1.3 


NUMBER; 2 

NAIiE: MONCLS 

l'^UrIC'.'.'.t:ON : Close 'a File 

STATJS: User 

CALLING SEQUENCE: . LDA N 

BRS 2 
. NORMAL RETURN 

N •-- I'ile number (obtained when file was opened) . 

DESCRIPTION: Th^i "cl03e file" BRS is used to indicate 
to the system all processing is completed on this file 
All ncce&; Gary termination processing will be completed 
:;.;.:,[ control will be transferred to the normal return. 
See also, BRS's 1, 8, and 82. 

REGISTERS AFFECTED: None ' 


2.1. k 


NUMBER: 20 

NAME: CPILE 

FUNCTION: Close a Pile 

STATUS: User 

CALLING SEQUENCE: LDA N 

BRS 20 

N = File Number 

DESCRIPTION: The "close file" BRS is used to indicate 
to the system all processing is completed on this file. 
If the file number indicates Mag Tape, the file will 
be terminated and if output, the End of File will be 
written; but in either case, the tape will be positioned 
at the start of the next file and the tape is de-allocated 
All registers are clobbered. 

REGISTERS AFFECTED : All 


2.1.5 


MUNBER: 8 

NAME: lOH 

PUKGTION: Close all Files 

STATJS: User 

CALLING SEQUENCE: BRS 8 

NORMAL RETURN 

DESCRIPTION: The '•'close all files" BRS is used to in- 
dicate to the S5^stem all pi'ocessing is completed on 
all files. The system v/ill complete all necessary ter- 
mination processing on all files and transfer c-ontrol 
to the normal return. BRS 8 is always executed when 
control returns to the system. This BRS will not close 
magn'^tic tape files correctly. See also, BRS 1 (2.1.1)3 
2 (2.1.3)3 82 (2.1.8), and 17 (2:2.3). 

RI::GISTERS affected: None. 


2.1.6 
Rev. 8/67 


NUMBER: 66 

NAME: DFDL 

FUNCTION: Delete DSU File Data 

STATUS : User 

CALLING SEQUENCE: LDA N 

BRS 66 
NORMAL RETURN 

D ■ N = File Number 

DESCRIPTION: /^'This BRS will return to available storage 
all DSU blocks^ich are assigned to the indicated file 
and clear the imex block of DSU addresses. The file 
must be open as an output file. 

REGISTERS AFFECTED: None 


2.1.7 


NUMBER: 6? 

NAME: DPER 

FUNCTION: Delete a Specified Block of the DSU .. 

STATUS: System 

CALLING SEQUENCE: LDA D 

BRS 67 
NORMAL RETURN 

D = Address of the DSU block. 

DESCRIPTION: This BRS will return the DSU block-indi- 
cated by the address in register A to available storage 
and transfers control to the normal return. This BRS 
should be used to delete Index Blocks. The BRS does 
not clear the Index Block address from the Customer 
File Directory. 

REGISTERS AFFECTED: None 


2.1.8 


NUMBER: 82 

NAME: SWSP 

FUNCTION: Switch Sequential Pile Type 

STATUS: User 

CALLING SEQUENCE : LDA N 

LDB C 
BRS 82 

N = Pile number 

C = will make the file an input file. 

C =1 will make the file an output file. 

DESCRIPTION: This BRS sets the file type to input or 
output depending on the contents of register B regard- 
less, of its current file type and transfers control to 
the normal return. RESTRICTION.: If the sign bit of 
register A was set when the BRS 1 (2,1.1) was executed 
to open the file, it cannot be switched from input tO' 
output. A violation results in an instruction trap. 

REGISTERS APPECTED: None 


2.1.9 


NUMBER: 87 

NAME: DPRX 

FUNCTION: Read DSU File Index Block 

STATUS: System 

CALLING SEQUENCE: LDA D 

LDX W . 
BRS 87 
NORMAL RETURN 

D = DSU address of the index block (MOD ^) 
W = Core address into which the block is to be 
read. ' 

DESCRIPTION: Reads the specified block into the given 
core location and transfers control to the normal return. 
The block read is the size of the currently defined in- 
dex block. The size of an index block varies with the 
assembly. 

REGISTERS AFFECTED: None 


2.1.10 


NUMBER: 10^1 

NAME: RSYB 

FUNCTION: Read a Page from the RAD 

STATUS: System 


GALLING SEQUENCE: 

LDA 

C 


LDB 

R 


BRS 

10^ 


C = Core Address 
R = RAD Address 

DESCRIPTION: Reads one page from the RAD starting at 
the address R into a page in core. C may. be any loca- 
tion in that page. The data will start in the first 
word of the page . 

Uncorrectable RAD errors result in an instruction trap 
Or interrupt 11 if it is armed. Try command again.;; 

REGISTERS- AFFECTED : None 


2.1.11 


NUMBER: 105 

NAME: WSYB 

FUNCTION: V/rlte a Page on the RAD 

STATUS: System 

CALLING SEQUENCE: LDA C 

LDB R 
BRS 105 
NORMAL RETURN 

DESCRIPTION: Writes one page on the RAD starring at 
the address .R from a page In core. C may be any loca- 
tion in that page. The data will start in the first 
word of the page. 

Uncorrectable RAD errors result in an instruction trap 
or interrupt 11 if it is armed. Try command again. 

REGISTERS AFFECTED: None 


2.1.12 


NUMBER: 113 

NAME: DFCD 

FUNCTION: Compute Pile Size of a DSU Pile 

STATUS: User 

CALLING SEQUENCE: LDA =Pile Number 

BRS DPCD 
NORMAL RETURN 

DESCRIPTION: Adds the number of data words (in multiples 
of 255) in the file to the number in the X register. 
Returns, the result in X. 

REGISTERS AFFECTED: X 


2.1.13 


NUMBER: 11^ 

NAME: MTDI 

FUNCTION: Turn Of f Run-away Magnetic Tape 

STATUS: System 

CALLING SEQUENCE: BRS MIDI 

NORMAL RETURN . 

DESCRIPTION: Issues commands to. try to stop the tape 

REGISTERS AFFECTED: None 


2.1.1^ 


NUMBER: ll8 

NAME: TGET 

FUNCTION: Allocate Magnetic Tape Unit 

STATUS: System 

CALLING SEQUENCE: LDA =Tape Number 

BRS 118 
EXCEPTION RETURN 
NORMAL RETURN 

DESCRIPTION: Assigns tape requested to the user. If 
tape is already busy with someone else the execption 
return is executed. 

REGISTERS AFFECTED: None 


2.1.15 


NUMBER: 119 

NAME: TREL 

FUNCTION: De-Allocate Magnetic Tape Unit 

STATUo: System 

CALLING SEQUENCE : LDA -Tape Nunib er 

BRS 119 
NORMAL RETURN 

DESCRIPTION: Releases the tape specified. Releases 
regardless of who had it. 

REGISTERS AFFECTED: None 


2.1.16 


NUMBER : BE+9 

NAME : RDSYB 

FUNCTION: Read DSU Page 

STATUS: System 

CALLING SEQUENCE: LDA C 

LDB R 
BRS BE+9 

C = Core Address 
R = RAD Address 

DESCRIPTION: Use like 10^. Can only be called by the 
system exec. BE+1 (2.1.19) can be used to perform 
this function. 

REGISTERS AFFECTED: None 


2.1.17 


NUMBER: BE+10 

NAME: WDSYB 

FUNCTION: Write DSU Page 

STATUS: System 

CALLING SEQUENCE: LDA C 

LDB R 
BRS BE+10 

C = Core Address 
R = RAD Address 

DESCRIPTION: Use like 105 (2.1.11). Can only be called 
by the system exec. BE+2 (2.1.20) should be used to 
pL;rform this function. 

REGISTERS AFFECTED: None 


2.1.18 


NUMBER: BE+7 

NAME: BPTEST 

FUNCTION: Test a Breakpoint Switch 

STATUS: System 

CALLING SEQUENCE: LDX =Switch Number 

BRS BE+7 
SWITCH UP RETURN 
SWITCH DOWN RETURN 

DESCRIPTION: Tests the breakpoint switch (1,2,3,^) 
Indicated in X. If the switch is down, the BRS skips 
on return. 

REGISTERS AFFECTED: None 


2,1.19 


NUMBER: BE+1 

NAME: ARD 

FUNCTION: Read DSU 

CALLING SEQUENCE: LDA =Core Address 

LDB =Disc Address 
LDX =Number of Words 
BRS BE+1 
NORMAL RETURN 

DESCRIPTION: Reads from the disc as specified. Errors 
result in an instruction trap, or programmed interrupt 
11 if it is armed. No two forks that are to run simul- 
taneously should both use this BRS. 

REGISTERS AFFECTED: None 


2.1.20 


NUMBER: BE+2 

NAME: AWD 

FUNCTION: Write DSU 

STATUS: System 

CALLING SEQUENCE: LDA =Core Address 

LDB =Disc Address 

LDX =Number of V/ords 

. BRS BE+2 

DESCRIPTION: Like BE+1 (2.1.19). The number of words 
must be a multiple of 6^ and greater than 0. 

REGISTERS AFFECTED: None 


2 .2.1 


NUMBER: 15 

NAME: GPN . 

FUNCTION: Reads Input File Name from a Command Pile 

and Looks up the Pile Name in the User's Pile 
Directory. 

STATUS: User 

CALLING SEQUENCE: LDA N 

BRS 15 

EXCEPTION RETURN 
NORMAL RETURN 

N = Command Pile Number 

DESCRIPTION: The routine ignores leading spaces ^ leading 
multi-blanks, and leading carriage return characters. 
It then uses the BRS 37 (5.2.2) to look up the file name 
in the user's file directory hash table.* It returns 
in bhe registers for both returns exactly what the BRS 
37 puts there, which is: 

Exception Return: X: Pointer to the input 

file name string pointers. 

A & B: Input file name string 
pointers . 
Norma] Return: A: Pointer to the string 

pointers of the desired 
file in the file directory 
hash table. 

B: The value word of the 
hash table entry. 

X: Clobbered. 

•^The exception return is taken if the input file name 
string cannot be located in the file directory. 

NOTE: The information contained in the registers cannot 
be used directly by the user since the addresses are 
in the T.S. Block; this BRS is normally followed by the 
BRS 16 . 

If the input file name string begins with a left paren, or 
with the full quote, the file name will be located in 
another user's file directory or in the public file direc- 
tory, respectively; in these cases, the input command 
file must be the teletype. Since the BRS 37 is not used 
in thlb case, the information in the registers is of 
no practical use to the user,, and the BRS MUST be followed 
by the BRS l6 (2.2.2) as indicated under the BRS 16. 

REGISTERS AFFECTED: None 


2.2.2 
Rev. 8/67 


NUMBER: l6 

NAME: GIPNB 

FUNCTION: Open Input Pile in Pile Directory. 

STATUS: User 

CALLING SEQUENCE: LDA N 

BRS 15 
BRU (Error) 
BRS 16 

EXCEPTION RETURN 
NORMAL RETURN 

N = Pile Directory Pointer Address 

DESCRIPTION: Opens an input file located in the user's 
file directory. The BRS requires in A, the location 
of the first word of the entry in the file directory 
hash table. The exception return is taken if the pointer 
in A is not pointing to a proper location in the hash 
table 3 or if the file cannot be opened, for any reason, 
such as a physical device that cannot be an input file. 
The file directory pointer may be obtained from a BRS 
15, a BRS 48 or a BRS 60. . 

Exception Return: All registers clobbered. 


Normal Return: A 

B 
X 


REGISTERS APPECTED : All 


File Number 
Pile Type (0-^) 
Pile Size 


2.2.3 


NUMBER: 17 

NAME: UABORT 

FUNCTION: Close all Piles (Including Mag Tape) 

STATUS: User 

CALLING SEQUENCE: BRS 17 

DESCRIPTION: If mag tape has been used, the last record 
will be terminated and if output, the End of Pile will 
be written; in either case the tape will be positioned 
at the start of the next file. The tape is then closed 
and the unit is de-allocated. See also, BRS 8 (2.1.5). 
All registers are clobbered. 

REGISTERS AFFECTED: All 


2.2.i| 


NUMBER: l8 

NAME: GOPNA 

FUNCTION: Reads Pile Name from a Command Pile and Looks 
Up the Pile Name in the User's Pile Directory. 
The Command Pile Must Be an Input Pile. 

STATUS: User 

CALLING SEQUENCE : LDA N 

BRS 18 

EXCEPTION RETURN 
NORMAL RETURN 

N = Command Pile Number 

Bit 1 = 1 of A Register = Assume a file name is 

correct and does not type "OLD PILE" or "NEW PILE" . 

DESCRIPTION: The routine ignores leading spaces, leading 
multi-blanks 5 and leading carriage return characters. 
If the string begins and ends with a single quote or 
a slash, the string is terminated for look-up with this 
character and the string is looked up in the user's file 
directory using the BRS 5 (5.2.1). A confirming carriage 
rettirn must followtthe quote or slash before the string 
is looked up. The exception exit is taken if the charac- 
ter is not a carriage return. If the string is found 
in the file directory hash table, the message "OLD PILE" 
is typed, otherwise the message "NEW PILE" is typed. 
If a confirming line feed, carriage return, or period 
is then next in the input string, the normal return will 
be taken, otherwise the exception return. In the case 
of a new file, the file name is inserted conditionally 
into the file directory. 

If the string begins with a character other than a single 
quote or a slash, the string is looked up in the user's 
file directory using the BRS 37 (5.2.2). If the string 
is not located, the error exit is immediately taken caus- 
the exception return. The exception return will also 
be caused if the file is read only as Indicated by the 
flag in the file directory. 

Exception Return: All clobbered. 
Normal Return: A - Location of the file In the 

directory hash table. 
B - Confirming character in case 
of a quote or slash file; 
otherwise, the file directory 
hash table value word. 
X - Clobbered . 

REGISTERS APPECTED : All 


2.2.5 
Rev. 8/67 


NUMBER: 19 

NAME : GOFNB 

FUNCTION: Open Output File Located in File Directory 

STATUS: User 


CALLING SEQUENCE : 


LDA 

Nl 

LDB 

N2 

LDX 

N3 

BRS 

19 


(For Tape Files Only) 


EXCEPTION RETURN 
NORMAL RETURN 

Nl = Information supplied in A by BRS 18 (2.2.4), 

BRS 48 or BRS 60 (location in the file directory) , 

N2 - File Size (as supplied in X by BRS 16) for tape 
files only. 

N3 - File Type (as supplied in B by BRS 16). 

DESCRIPTION: Opens an output file located in the user's 
file directory. The information required in the registers 
is indicated above. The word in A is checked for legality. 
If it is now a valid pointer, the exception return is taken, 
The exception return is also taken if the file cannot be 
opened for any reason, such as a physical device that can- 
not be used for output. In the case of a new file, the 
file directory entry is completed. If the new file is a 
DSU file and it cannot be opened, the message "NO ROOM" 
is typed. The message "FILE TYPE WRONG" is typed as approp- 
riate. 

Exception Return: All clobbered. 
Normal Return: A- File Number. 

B & X -Clobbered. 

REGISTERS AFFECTED : All 


2.2.6 


NUMBER: 48 

NAME: GSPN 

FUNCTION: Look. up Input/Output File Name 

STATUS: User 

CALLING SEQUENCE: LDP N 

BRS 48 

EXCEPTION RETURN 
NORMAL RETURN 

N = String pointers for the file name. 

DESCRIPTION: The file name is looked up in the file 
directory hash table using the BRS 5 (5.2.1). If it 
is not there, the exception return is taken. 

Exception Return: A & B - No change. 

X - Clobbered. 
Normal Return: A & B - Location in file directory 

hash table. Can be 
used by BRS 16 (2.2.2) 
or BRS 19 (2.2.5). 
X - Clobbered. 

REGISTERS AFFECTED: All 


2.3.1 


NAME: CIO 

FUNCTION: Character Input/Output 

STATUS: User 

CALLING SEQUENCE: LDA C (Output Only) 

CIO N 

C = 8 bit data character right justified. 

N = Address of word containing a file number. 

DESCRIPTION: CIO is used to input or output a single 
character from, or to, a file from the A register. On 
input an End of Record or End of Pile condition will 
set bits and 8 or bits and 7 in the file number and 
return a 13^8 ^^ 1373 character, respectively. If in- 
terrupt 4 is armed (see BRS 78, "1.1.1"), it will occur. 
The End of Record occurs on the next input operation 
after the last character of the record has been input 
and the End of File condition occurs on the next input 
operation after the End of Record which signals the last 
record of the file. If an error occurs, bits and 6 
ivlll be set in N and interrupt 4 will occur if it is 
armed. 

WIO and BIO should not be mixed with CIO to read or write 
a given file. 

REGISTERS AFFECTED: A 


2.3.2 


NAME:. WIO 

FUNCTION: Word Input/Output 

STATUS:. User 

CALLING SEQUENCE: LDA D (Output Only) 

WIO N 

D = Data word to be written 

N = Address of word containing a file number. 

DESCRIPTION: WIO is used to input or output a word of 
data to or from the A register. On input an End of Record 
condition returns a word of three 13^8 characters and 
sets bits and 8 in the file number word. If interrupt 
4 is armed (see BRS 78, "1.1.1"), it will occur. An . 
End of Pile condition returns a word of three 1378 charac- 
ters and sets bits and 7 in the file number word. 
If interrupt 4 is armed, it will occur. If an End of 
Record or Pile condition occurs with a partially filled 
out word, the word is completed with 13^8 ^-^ ^378 charac- 
ters.. If an error occurs, bits and 6 are set in N. 
If interrupt 4 is armed it will occur. 

CIO and WIO should not be mixed to read or write a given 
file. 

REGISTERS AFFECTED: A. 


2.3.3 


NAME: BIO 

FUNCTION: Blocked Input/Output 

STATUS: User 

CALLING SEQUENCE : LDA W 

LDX I 
BIO N 

EXCEPTION RETURN 
NORMAL RETURN 

I - Starting memory address. 

W = Number of words to be read or written. 

N = Address of word containing a file number-. 

DESCRIPTION: BIO is used to input a block of words to 
memory or output a block of words from memory. The A 
register vjill contain the first memory location not read 
into or out of at the end of the operation. If the oper- 
ation is completed successfully, control will be trans- 
ferred to the normal return, otherwise control will be 
transferred to the exception return. 

On input an End of Record or End of Pile condition will 
set bits and 8 or and 7 in the file number. An 
error will set bits and 6. Interrupt ^ will occur 
if armed when any of these bits are set. 

Exception conditions are: 

1. End of Record 

2. End of File 

3. B'.l.d Record 

If bi.t 1 is on in the Data Block disc address in the 
Index Block of a DSU file, it indicates the end of the 
data blocks and is the end of a logical record. 

REGISTERS AFFECTED: A,X 


2.3.^ 


NAME: CTRL 

FUNCTION: Input/Output Control (only tape is Implemented) 

STATUS: System 

CALLING SEQUENCE : LDA C 

CTRL N 

C = Control number 
N = File number 

DESCRIPTION: CTRL provides the following control func- 
tions for tape files: 

Control H Description 

1. Write end of record on output. Record 
count not used. 

2. Backspace physical block. 

3. Forward space physical block. 

4. Backspace file. 

5. Erase tape (output only) (3 inches). 

6 . Rewind . 

7. Write EOF. Output only. 

8. Long erase. Output only. 
REGISTERS AFFECTED: None 


3.1.1 


Mot implemented 


NUMBER: 23 

NAME: LNKS 

FUNCTION: Link/Unlink TTY ■ 

STATUS: User 

CALLING SEQUENCE: LDX T 

LDA A 

LDB C 

BRS 23 


T ■•= Teletype number 

A = Address of a list of teletype numbers terminated 

with -2, 
- Control word. The bits of this word are as 

follows : . 

Bit ^ = Output LCW, 1 =^ Input LCW. 

Bit 1 " = Clear all links first, 1 = Do not 
clear links first. 

Bit 2^ = Set link bits for TTY whose numbers 
are in the table . 

Bit 2 = 1 = Clear link bits for TTY whose num- 
bers are in the table. 


DESCRIPTIION: 

TTY T in Che 
called the ab 
trol words Tl 
bit for each 
asiiociated wi 
and output . 
BRS. ProMi th 
plied in the 
created. Eac 
ab GO lute LOW 


This BRS is used to set the link bit for 
LCW. Associated with each TTY are two words 
solute input and absolute output link con- 
CW's). Each of these words contain one 
TTY in the system (maximum of 24). Also 
th each TTY are relative LCW s for input 
The bits in these LCV/'s are set by this 
e old relative LCu and the Information sup- 
calling sequence a new relative LCW is 
h time any relative LCV/ is changed, the 
s are all recomputed. 


Lin): bi'js set in the input LCW cause input characters 
to be ntored in the buffer. of all TTY's linked to the 
controlling TTY, Link bits set in the output LCW cause 
output characters, including echoes, to be output to 
all TTY's linked to the controlling TTY. 


REGISTERS AFFECTED: None 


3.1.2 


NUMBER: 2^ 

NAME: LNKC 

FUNCTION: Unlink - not implemented 

STATUS: System 

CALLING SEQUENCE : LDX T 

BRS 2H 

T = Teletype Number 

DESCRIPTION: This BRS is used to clear all links,, input 
and output, to or from TTY T. 

REGISTERS AFFECTED: None 


3.1.3 


NUMBER; 25 

NAME: MSGS - Not "implemented 

FUNCTION: Set Accept Mersages and Set Accept Input In- 
dicators . 

STATUS: System 

CALLING SEQUENCE: LDX T 

LDA I 
BRS 25 

T = Teletype number (must be controlling TTY or 

an attached TTY) . 
I = Bit 23 on to set "Accept Messages" Indicator. 
I = Bit 2H on to set "Accept Input" Indicator. 

DESCRIPTION: This BRS allov;s the user to specify whether 
or not messages from outside will be accepted, and whether 
or not Input from outside will be accepted for his con- 
trolling teletype or for one which he. has attached. 
The accept message Indicator controls execution of OST 
Instructions and the setting of teletype output links. 
The accept input indicator controls execution of STI 
instructions and the setting of teletye input links. 
Setting or clearing of these Indicators will not affect 
any TTY links currently set. 

REGISTERS AFFECTED: None 


3.1.4 


NUMBER: 27 

NAME: ASTT - not implemented 

FUNCTION: Attach TTY to this program 

STATUS: System 

CALLING SEQUENCE: LDA T 

BRS 21 

EXCEPTION RETURN 
NORMAL RETURN 

T = Teletype Number 

DESCRIPTION: To give total control over a TTY to the ' 
requesting program. If the indicated TTY is free, it 
is attached to the requesting program and transfers con- 
trol to the "normal return" . If it is not free, control 
is transferred to the "exception return" . 

REGISTERS AFFECTED: None 


3.1.5 


NUMBER: 28 

:vfAME: RSTT - nob implemented 

FUNCTION: Release TTY 

STATUS: System 

CALLING SEQUENCE: LDA T 

BRS 28 

T - Teletype Number 

DESCRIPTION: Returns to a free status the TTY indicated 
by the A register. If the TTY was not attached to the 
requesting program a "panic" will be executed. 

NOTE: All attached teletypes are released when the user 
logs out . 

REGISTERS AFFECTED: None 


3.1.6 


NUMBER: BE+3 

NAME: CARRY 

FUNCTION: Test for Carrier Presence 

STATUS: System 

CALLING SEQUENCE: LDA =LINEj^ 

BRS BE+3 

EXCEPTION RETURN - No Carrier 
NORMAL RETURN - Carrier Present 

DESCRIPTION: This BRS gives a skip return. If the car- 
rier signal Is present on the line Identical In A. No 
carrier signal - no skip. 

REGISTERS AFFECTED: None 


3.1.7 


NUr4BER: BE+6 . ■ 

NAME: TTYON 

FUNCTION: Turns a Teletype Line On or Off. 

status;: System 

CALLING SEQUENCE: LDA =TTY // 

LDB =0 (off) or -1 (on) 
BRS BE+6 
NORMAL RETURN 

DESCRIPTION: Issues the EOM and POT commands which cause 
the line to be turned off (hung up) or made ready to 
accept an incoming call. 

REGISTERS AFFECTED: None 


3.2.1 


NUMBER: 11 

NAME: CIB 

FUNCTION: Clear the Teletype Input Buffer 

STATUS: User 

CALLING SEQUENCE: LDX. T 

BRS 11 

T = Teletype number (-1 Is used to indicate the 
controlling teletype) . 

DESCRIPTION: Sets the buffer pointers to indicate there 
are no characters in the TTY input buffer. 

REGISTERS AFFECTED: None 


3.2.2 


NUMBER: 29 

NAME: COB 

FUNCTION: Clear the Output Buffer 

STATUS: User 

CALLING SEQUENCE : LDX T 

BRS 29 

T = Teletype Number (-1 indicates the controlling 
TTY) 

DESCRIPTION: Sets the buffer pointers to Indicate there 
are no characters in the TTY output buffer. 

REGISTERS AFFECTED: None 


3.2.3 
Rev. 8/67 


NUMBER: .12 

NAME : GET 

FUNCTION: Declare Echo Table 

STATUS: User 


CALLING SEQUENCE: 

LDX 

T 


LDA . 

R 


BRS 

12 


T = Teletype number (-1 is used to indicate the con- 
trolling TTY) . 

R = 0,1,2, or 3 to indicate the proper echo table. 

R may also contain any eight-bit character if the 
sign bit is on. In this case, each eight bit 
character read from the teletype is transmitted 
unchanged to the user's program. No echoes are 
generated while in this special eight-level mode. 
The eight bit character is the character on which 
eight-level mode will teanninate. 

DESCRIPTION: BRS 12 sets the echo table for the TTY in- 
dicated by Register A. Echo tables are as follows: 

= Echo each character just as it was received and 

break on all characters. 

1 = Same echo as but all characters except letters , 

digits and spaces are break characters . 

2 = Same echo as 0, but the only break characters are 

control characters (including carriage return and 
line feed) . 

3 = No echo for any character and break on all charac- 

ters. 

REGISTERS AFFECTED: None 


3.2.^ 


NUMBER: ^)0 

NAME: RDET 

FUNCTION: Read Echo Table 

STATUS: User 

CALLING SEQUENCE: LDX T . 

BRS Mo 

T = Teletype number 

DESCRIPTION: Reads the echo table number (0,1,2,3) into 
the A register. 

If the teletype is not in eight-level input mode, reads' 
the echo table number (0,1,2,3) into the A register. 
If the teletype is in eight-level input mode, the sign 
bit of A is set, the address field contains the terminal 
character. 

REGISTERS AFFECTED: A 


3.2.5 


NUMBER: 13 

NAME: SKI 

.FUNCTION: Test Input Buffer for Empty 

STATU3: User 

CALLING SEQUENCE: LDX- T 

BRS 13 

EXCEPTION RETURN 
NORMAL RETURN 

T ^- Teletype number (-1 is used to indicate the 
controlling TTY) 

DESCRIPTION: This BRS tests for the presence of input 
characters in the buffer. If the buffer is empty, con- 
trol is transferred to the "normal return" . If there 
are any characters in the input buffer, control is trans^ 
ferred to the "exception return". 

REGISTERS AFFECTED: None 


3.2.6 
Rev. 8/6 7 


NUMBER: 14 

NAME: DOB 

FUNCTION: Dismiss Until the Teletype Output Buffer is 
Empty. 

STATUS: User 

CALLING SEQUENCE : LDX T 

BRS 14 

T = Teletype number (-1 is used to indicate the con- 
trolling TTY) . 

DESCRIPTION: Dismiss this fork until the teletype output 
buffer indicated is empty. It is dismissed until the last 
interrupt is received. 

REGISTERS AFFECTED: None 


3.2.7 
Rev. 8/67 


NUMBER: 85 

NAME: SET8P 

FUNCTION: Set Special Teletype Output 

STATUS: User 

CALLING SEQUENCE: LDX T 

BRS 85 

T = Teletype number (-1 is used to indicate control- 
ling TTY) . 

DESCRIPTION: Sets teletype to 8~level output mode. The 
teletype specified must either be the controlling teletype 
or an attached teletype. Eight-level is transmitted to 
the teletype exactly as it is received from the user 
program. A fork sending eight-level code should do a BRS 
14 before terminating. 

REGISTERS AFFECTED: None 


3.2.8 


NUMBER: 86 

NAME: CLR8P 

FUNCTION: Clear Special Teletype Output 

STATUS : User 

CALLING SEQUENCE: LDX T 

BRS 86 

T = Teletype number (-1 Is used to indicate con- 
trolling TTY) . 

DESCRIPTION: Puts the teletype output back into normal 
mode. The teletype specified must either be the con- 
trolling teletype or attached. 

REGISTERS AFFECTED: None 


3.2.9 
Rev. 8/67 


NUMBER: BE+11 

NAME: CRSW 

FUNCTION: To Allow the User to Ignore Line Feed or Car- 
riage Return when it Follows a Carriage Return 
or Line Feed. 

STATUS: User 

CALLING SEQUENCE: LDX -1 

LDA =0 (ignore) =-1 (do not ignore) 
BRS BE+11 
NORMAL RETURN 

DESCRIPTION: The contents of the A register will give 
the following results. If A is negative, all line feeds 
and carriage returns received from the TTY will be sent 
to the program and echoed. If A is positive, a line feed 
after a carriage return received from the TTY will be 
ignored (not sent to the program and not echoed) and a 
carriage return after a line feed will be ignored (not 
sent to the program and not echoed). In all cases the 
first line feed or carriage return received will be sent 
to the program and echoed plus echo it's compliment. 

REGISTERS AFFECTED: None 


3.2.10 


NAME: TCI 

FUNCTION: Teletype Character Input 

STATUS : User 

CALLING SEQUENCE: TCI M 

M = Memory location. 

DESCRIPTION: This SYSPOP reads the character from the 

teletype input buffer and places it into the location 

M right justified. The remainder of location M is cleared 

The character is also placed in the A register right 

Justified. 

REGISTERS AFFECTED: A 


3.2.11 


NAME : TCO 

FUNCTION: Teletype Character Output 

STATUS: User 

CALLING SEQUENCE: TCO M 

M = Memory address. 

DESCRIPTION: This SYSPOP outputs the character from 
the right-most eight bits of location M to the control- 
ling teletype. In addition to the ordinary ASCII" char- 
acters ^ all teletype output operations will accept 135q 
as a multiple blank character. The next character will 
be taken as a blank county and the indicated number of 
blanks will be typed. 

REGISTERS AFFECTED: None 


3.2.12 


NAME: 1ST (Mot implemented) 

FUNCTION: Input From Specified Teletype 

STATUS: User 

CALLING SEQUENCE: 1ST T 

T = Teletype number 

DESCRIPTION: 1ST is used to input a character from an 
attached teletype. The character will be right Justi- 
fied in the A register upon return. 

REGISTERS AFFECTED: None 


3.2.13 


NAME: OST (Mot implemented) 

FUNCTION: Output to Specified Teletype 

STATUS: User 

CALLING SEQUENCE: OST T 

T = Teletype number 

DESCRIPTION: OST is used to output a character in the 
A register to a specified teletype. This instruction 
is used for output to an attached teletype. It's accept 
message bit must be set or an illegal instruction panic 
v/ill be generated.. 

REGISTERS AFFECTED: None 


3.2.14 


NAME : STI 

FUNCTION: Simulate Teletype Input 

STATUS : User 

CALLING SEQUENCE: STI T 

T = Teletype number 

DESCRIPTION: This BRS is used to simulate teletype 
input. It puts the character in the A register into 
the input buffer of the specified teletype. It is legal 
for a user fork only if T equals the controlling TTY 
or -1. 

REGISTERS AFFECTED: None 


4.1.1 


NUMBER: 4 

NAME: MPT 

FUNCTION: Release a Page of Memory 

STATUS: User 

CALLING SEQUENCE: LDA N 

BRS 4 

N a Contains any address in the page to be released 

DESCRIPTION: The PMT entry for the block is removed 
and in any other fork which has this PMT byte in its 
relabeling, the byte is cleared to 0. 

REGISTERS AFFECTED: None 


4.1.2 


NUMBER: 121 

NAME: DPMTE 

FUNCTION: Release Specified PMT Entry 

STATUS: User 

GALLING SEQUENCE: LDA R 

BRS 121 

R = Relabeling byte 

DESCRIPTION: Releases the specified page from the PMT, 
It is exactly like a BRS 4 (4.1.1) except that it takes 
a byte number instead of an address. 

Instruction Trap: 

1) Byte not in PMT. 

2) A user fork tried to release a system page. 

REGISTERS AFFECTED: None 


^.1.3 


NUMBER: 120 

NAME: APMTE , 

FUNCTION: Assign PMT Entry 

STATU.;: System 

CALLING SEQUENCE: LDA R 

BRS 120 

R = Relabeling byte 

DESCRIPTION: Obtains a new page for the relabeling 
byte specified. This BRS is used only in the recover 
routine in the exec. 

IhL; true t ion Trap: 

1) PMT entry is already assigned. 

2) The relabeling byte number was not in the PMT 

REGISTERS AFFECTED: None 


4.1.il 


NUMBER: ^3 

NAME : RDRL 

FUNCTION: Read Pseudo-Relabellnn; 

STATUS: User 

CALLING SEQUENCE: . BRS ^3 

DESCRIPTION: Reads the current pseudo-relabeling regiS' 
ters Into registers A and B. 

REGISTERS AFFECTED: A,B 


4.1.5 


NUMBER: MH 

NAME: STRL 

FUNCTION: Set Pseudo-Relabeling 

STATUS: User 

CALLING SEQUENCE: LDA Rl 

LDB R2 
BRS 44 

Rl & R2 = Relabeling factors 

DESCRIPTION: This BRS takes the contents of registers 
A and B and stores them into the current pseudo-relabel^ 
ing registers. It also causes the real relabeling to 
be reset to correspond to the new pseudo-relabeling. 

This BRS will result in an instruction trap for any of 
the following reasons: 

1) Swapping in the new pages was not completed. 
(Usually because of a RAD failure.) 

2) The user tried to relabel over a system page. 

3) The user tried to relabel over a page he did 
not have. (This is not the way to obtain more, 
memory . ) 

REGISTERS AFFECTED: None 


4.1.6 


NUMBER: ll6 

NAME: RURL 

FUNCTION: Read User Relabeling 

STATU3: System 

CALLING SEQUENCE: BRS 116 

DESCRIPTION: Puts the program relabeling into A and B, 
This is what the system executive uses as program re- 
labeling. It is kept in the TS block. 

REGISTERS AFFECTED: A,B 


4.1.7 


NUMBER: 11? 

NAME: SURL 

FUNCTION: Set User Relabeling 

STATU..; : System 

CALLING SEQUENCE: LDA RLl 

LDB RL2 
BRS . 117 

RLl and RL2 are the new values for the program 
relabeling. 

DESCRIPTION: Sets the program relabeling as specified 
This BRS is used by the system. User programs should 
use BRS 44 to set relabeling for a fork. 

Instruction Trap: 

1) A specified relabeling byte, was not assigned. 

2) A user fork tried to relabel a system byte. 

REGISTERS AFFECTED: None 


4.1.8 


NUMBER: 122 . 

NAME : MPAN 

FUNCTION: Simulate Memory Panic 

STATUS: System 

CALLING SEQUENCE: LDA A 

BRS 122 

A = Core address 

DESCRIPTION: This BRS gets new memory for a class 3 
BRS. If It succeeds the new memory is put into the 
relabeling of the calling program. Can be issued from 
a class 3 BRS only. 

If a memory trap occurs, it looks to the calling program 
like it came from the BRS instruction. 

REGISTERS AFFECTED: None 


i|.1.9 


NUMBER: 56 

NAME: MBEX 

FUNCTION: Make Page System 

STATUS: System. 

CALLING SEQUENCE: LDA P 

BRS 56 

P = Pseudo-Relaboling byte for page. 

If bit of A = 1 , page will be made system. 

If bit of A = 0, page will be made not system. 

DESCRIPTION: Sets the use mode of a page depending on 
the value of bit in the A register. 

Bit of A is set to 1 if page was formerly system or 
if it was not . 

REGISTERS AFFECTED: A 


^.1.10 


NUMBER: 80 

NAME : MBRO 

FUNCTION: Make Page Read Only 

STATUS: User . 

CALLING SEQUENCE: LDA P 

BRS 80 

P ^ PMT/SMT number 

If bit of A = 1, make page read only. 

If bit of A = 0, make page read-write. 

DESCRIPTION: Sets the read-write status of the entry 
according to the value of A. An SMT entry can only be 
changed by a system fork. The former status of the 
entry is returned in A . 

Instruction trap: 

1) Specified entry is not in use. 

2) The swap failed. 

PEGISTERS AFFECTED: A 


^.1.11 


NUMBER: BE+5 

NAME: PEERS 

FUNCTION: Reads or Sets One Word in the Monitor 

STATUS: System 

CALLING SEQUENCE: LDA V 

LDB or -1 

LDX =Locatlon in Monitor Relabeling 

BRS BE+^ 

RETURN 

V = New value for word if it is to be set . 

The contents of the location are returned in the 

A register. 

If B is positive, the word is read. 

If B is negative, the word is changed and the old 

value returned in A. 

DESCRIPTION: Allows a system program to read or set 
the contents of any location in the monitor relabeling. 

The original contents of the location are always returned 
in the A register. 

REGISTERS AFFECTED: A 


^.2.1 


NUMBER: 68 

NAME: EBSM 

PUNCTION: Enter Block in SMT - Not implemented. 

STATUS: System 

CALLING SEQUENCE: LDA B 

BRS 68 

B = Byte number in users pseudo-relabeling 

DESCRIPTION: A free SMT entry Is found and the PMT 
entry put into it. The SMT number is returned in A. 

REGISTERS AFFECTED:. A 


4.2.2 


NUMBER: 69 • 

name': GBSM 

FUNCTION: Get SMT Block to PMT - Not implemented. 

STATUS: Subsystem 

CALLING SEQUENCE: LDA S 

BRS 69 

S = SMT number 

DESCRIPTION: Puts the SMT entry into the first free 
PMT entry. The PMT entry number is returned in A. 

Instruction trap: 

1) A user program tries to relabel a system SMT 
entry . 

2) The SMT number is not valid. 

Memory trap: 

There were no free PMT entries. 
REGISTERS AFFECTED: A 


5.1.1 


NAME: GETSTR. 

FUiNiCTION: Read String 

STA'-i'US: User 

CALLING SEQUENCE: LDA A 

LDB T 

LDX F 

BRS 33 

A - Addresr. of string pointer 

T = .Terminal character 

F = File number 

Bit of A on - The string is taken as null with 

the second pointer equal to the first. 

DESCRIPTION: This BRS reads characters from the file 
and appends them to the string until the terminal char- 
acter is rc'iched. The terminal character is not appended 
to the string. It returns the updated string pointers 
in the A and B registers and updates the end string 
pointer in memory. 

REGISTERS AFFECTED: A,B . 


5.1.2 


NUMBER: 3^ 

NAF4E: OUTMSG 

FUNCTION: Output Messan;e' 

STATUS: User 

CALLING SEQUENCE: LDX F 

LDA W 

LDB C 

BRS 3^ 

F = File number 

VJ = Beginning word address 

C = Character count or -1 

DESCRIPTION: This BRS outputs C consecutive characters 
starting with the first character of the specified word. 
If B = -1, characters are output until a / is encountered- 
the character $ is interpreted as a carriage return and 
line feed. 

REGISTERS AFFECTED: None 


5.1.3 


NUMBER: 35 
NAME:. OUTSTR 
FUNCTION: Output String 
statu:;.: user 

CALLING SEQUENCE: LDX P 

LDA P 

LDB P+1 

BRS 35 

F " Pile number 

P, P-M - A string pointer pair 

DESCRIPTION: Outputs the string Indicated by the string 
pointers in registers A and B to the specified file. 

REGISTERS AFFECTED: None 


5.1.4 


NUMBER: BE+l^ 

NAME: 

FUNCTION: Input String v/ith Edit 

STATUS: User 

CALLING SEQUENCE: 


5.1.5 


NAME: CIT 


FUNCTION 


STATUS 


Character Input and Test 


User 


CALLING SEQUENCE: 


LDA N 
CIT P 

EXCEPTION RETURN 
NORMAL RETURN 


N= Character to be tested. 

F = File Number (see CIO) (Input Only) 

DESCRIPTION: The character in the A register is compared 
against the next character in the input file. If it 
compares 5 the normal return is taken and the character 
is removed from the input buffer. If it does not com- 
pare, the character is left in the input buffer and is 
returned in A . 


Exception Return: 
Normal Return: 


A - The next character in 
the input buffer. 
B & X - No change 

A - The character supplied 
remains in A (the char- 
acter is removed from 
the input buffer). 


REGISTERS AFFECTED: A 


5.2.1 


NUMBER: 5 

NAME: SSCH 

FUNCTION: Look Up String in Hash Table 

STATUS: User 

CALLING SEQUENCE: LDA P 

LDB P+1 
LDX T 
BRS 5 

EXCEPTION RETURN 
NORMAL RETURN 

P and P+1 = String pointers for a string to be 

looked up . 
T - Address of a three word table of the form: 

ZRO Hash Table Beginning Address 
ZRO Hash Table End Address 
ZRO 

DESCRIPTION: BRS 5 (5.2.1) searches the hash table for 
a string to match the string indicated by A and B regis- 
ters. If successful it returns in register B the ad- 
dress of the hash table string pointers, and in register 
A, the string "value" and executes the "normal" return. 
Otherwise 5 it executes the "exception" return with regis- 
ters A, B and X unchanged and the address of the next 
free hash table entry in word 3 of the table is pointed 
to by register X. (Word 3 will be -1 if the table is 
full.) The "value" is the hash image for this string. 


See BRS 6 (5.2.3) 
RRGISTEliS AFFECTED: A,B 


5.2.2 
Rev. 8/67 


NUMBER: 37 

NAME: GSLOOK 

FUNCTION: General String Lookup 

STATUS : User 

CALLING SEQUENCE: 


LDA 

F 


LDB 

S 


LDX 

T 


BRS 

37 


EXCEPTION 

RETURN 

NORMAL RETURN 


F = Input file number. 

S = Address of string pointer pair. 

T = Address of the Hash Table Control Table. 

DESCRIPTION: The hash table is scanned for a string to 
match the given one. If an exact match is found the normal 
return is taken (see exits below) . If the given string 
does not match the initial part of any hash table string, 
the exception return is taken. If the given string matches 
the initial part of some hash table string, characters from 
the input file are appended until the string is long enough 
either to determine a unique hash table string, with a 
matching initial part, or for no match to be possible, in 
which case the exception return is taken. In the case 
where a unique hash table string has been located, more 
characters are taken from input until an exact match is 
obtained, in which case the normal return is taken, or until 
the last character causes a mis-match. If the last charac- 
ter is alphanumeric, the exception return is taken since 
it is assumed that only a non-alphanumeric character, such 
as a space, carriage return, punctuation marks, etc., can 
be considered a proper terminator. The last character 
(which caused the mis-match) is left in the input file. 

Exits are as follows: (1) The exception return is taken 
on the no-match condition with a string pointer in A, B 
to the string so far collected. X is undisturbed. (2) The 
normal return is taken on a match with the address of a 
hash table string pointer in A and the string "value" in 
B. X is undisturbed. 

The "value" is the hash image for the string. 

See also, Berkeley Document No. 30.10.20 for more details. 

REGISTERS AFFECTED: None 


5.2.3 


NUMBER : 


NAME : SSIN 


FUNCTION: Insert String in Hash Table 
STATUS: User 


CALLING SEQUENCE: 


A,B, & X must have the output from BRS 5 
BRS 6 


DESCRIPTION: BRS 
hash table at the 
(5.2.1) v/hlch did 
is full (;/ord 3 of 
''Illegal Instructi 
for use in conjunc 
only after BRS ;. h 
more, string point 
table in any manne 
the scr-rining algor 
results ) . 


6 inserts the string poin 
point determined by the 1 
not find a match. If the 

the table pointed to by 
on" trap results. BRS 6 
tion v;ith BRS 5. It shou 
as failed to find a match 
ers should not be placed 
r other than with BRS 6 ( 
ithm used in BRS 5 may ca 


ter into the 
ast BRS 5 

hash table 
X is -1) an 
is intended 
Id be used. 
Further- 
in the hash 
otherwise 
use undesired 


BRS 6 does not physically move the string to which regis^ 
ters A and B point. On return, register B contains 
the address of the first word of the new hash table en- 
try and register A containing the "value" word of the 

entry . 


REGISTERS AFFECTED: A,B 


5.3.1 


NAME: STP 

FUNCTION: Store Pointers 

STATUS: User 

CALLING SEQUENCE: STP A 

A = Address of a string pointer pair. 

DESCRIPTION: This SYSPOP is generally used in conjunC' 
tion with LDP. It stores the contents of the A and B 
registers into the string pointers indicated in the 
calling sequence. 

REGISTERS AFFECTED: None 


5.3.2 


NAME.: LDP 

FUNCTION: Load Pointers 

STATUS: User 

CALLING SEQUENCE: LDP A 

A = Address of a string pointer pair. 

DESCRIPTION: This SYSPOP loads the string pointers 
indicated in the calling sequence into the A & B 
registers . 

REGISTERS AFFECTED: None • 


5.3.3 


NAME : SKSE 

FUNCTION: Skip on String Equal 

STATUS: Uder 

CALLING SEQUENCE: LDA B 

LDB E 
SKSE A 

EXCEPTION RETURN 
NORMAL RETURN 

A = Address of a string pointer pair. 
. B = Beginning string pointer. 
E = End string pointer. 

DESCRIPTION: If the string addressed by the pointers 
In the A and B registers is identical with the string 
addressed by A of the calling sequence, control will 
be transferred to the normal return. Otherwise, control 
v/ill be transferred to the exception return. If the 
strings are of different lengths or have different 
contents, control will be transferred to the exception 
return. 

REGISTERS AFFECTED: None 


5.3.^ 


NAME: SKSG 

FUNCTION: Skip on String Greater 

STATUS: User 

CALLING SEQUENCE: LDA B 

LDB E 
. SKSG A 
EXCEPTION RETURN 
NORMAL RETURN 

B = Beginning string pointer 

E = End string pointer 

A = Address of a string pointer pair. 

DESCRIPTION: The SYSPOP compares the string Indicated 
by A and B registers with the string indicated by A of 
the calling sequences character by character and termin- 
ates with the first unequal character. The numerical 
internal code representation of characters is used to 
determine inequality. If the strings are unequal for 
the entire length of the shorter one^ the longer one is 
indicated as greater. If the contents of the string 
addressed by the A and B registers is greater than the 
contents of the string addressed by A, control will be 
transferred to the normal return. Otherwise, control 
is transferred to the exception return. 

REGISTERS AFFECTED: None 


5.^.1 


NAME: GCI 

FUNCTION; Get Character and Increment 

STATUS: User 

CALLING SEQUENCE: GCI A 

EXCEPTION RETURN 
NORMAL RETURN 

A = Address of a string pointer pair. 

DESCRIP'V'ON: This SYSPOP reads into the. A register/ 
the first character from the string indicated by the 
beginning string pointer given in the calling sequence. 
If the string is null or empty, nothing is done and 
control is transferred to the exception return. If the 
string is not null it's first character is loaded into 
the A register right-justified, and the beginning string 
pointer is incremented by one such that the beginning 
string pointer now points to the string with the first 
character deleted. Control is transferred to the normal 
return. Unless a copy of the original pointer is saved, 
the contents of the string are effectively destroyed. 

REGISTERS AFFECTED: A 


5.^.2 


NAME:; WCI 

FUNCTION: Write Character and Increment 

STATUS: User 

CALLING SEQUENCE: WCI P 

P = Address; of string pointer pair. 

DESCRIPTION: WCI writes the character in the A regis- 
ter on the end of the string addressed by the end string 
pointer.. The end string pointer is incremented by 1. 

REGISTERS AFFECTED: B ; 


5.^.3 


NAME: GCD 

FUNCTION: Get Character & Decrement 

STATUS: User 

CALLING SEQUENCE: GCD P 

EXCEPTION RETURN 
NORMAL RETURN 

P =: Address of a string pointer pair. 

DESCRIPTION: A GCD is, in every way, similar to GCI 
except that the character is taken from the end of the 
specified string. 

The last character on the string is loaded in the A 
register, and end string pointer is decremented so" that 
it points to the prevl'^us character in the string. Con- 
trol is transferred to the exception return if the end 
pointer is not greater than the beginning pointer before 
it is decremented. 

REGISTERS AFFECTED: B 


5.^.^ 


NAME : WCD ■ 

FUNCTION: V/rites Character and Decrement 

STATUS: User 

CALLING SEQUENCE: WCD P 

P = Address of a string pointer pair. 

DESCRIPTION: This SYSPOP writes the character in the 
A register on the beginning of the string and decrements 
the beginning string pointer. 

REGISTERS AFFECTED: 


5.^.5 


NAME: WCH 

FUNCTION: Write Character 

.STATUS: User 

CALLING SEQUENCE: LDA C, 

WCH T 

C = A character right-Justified in the A register. 
T = The address of a three word table. The table 
is as follows : 

Word - A character address 
V/ord I - A character address 
V/ord 2 = A transfei' address 

DESCRIPTION: This' SYSPOP tries to write a character 
into the area defined by the character addresses in the 
table. Provided that the second address in the table 
is greater than the first address, WCH will write the 
character in A register into the character position 
indicated by the first character address plus one and 
will increment the first character address in the table 
If the first character address is equal to or greater 
than the ;'.*. ;cond character in the table the character 
is not written and control is transferred to the third 
word of the table with A and X registers undisturbed 
and the address of the WCH in the B register. The ad- 
dress in the third word of the table can be an exit to 
a routine v/hich allocates more memory or garbage col- 
lects the ".•oil iiinlng- characters . 

REGISTERS AFFECTED: None 


6.1.1 


NUMBER: 36 

NAME: OUTNUM 

FUNCTION: Output number 

STATUS: User 

CALLING SEQUENCE: LDX P 

LDA N 

LDB R 

BRS .36 

F = File number 

N = Number to be output 

R = Radix 

DESCRIPTION: Outputs a number in the radix R. The 

number will be output as an unsigned 24 bit integer. 

If the radix is less than 2, an instruction trap will 
be given. 

REGISTERS AFFECTED: None 


6.1.2 


NUMBER: 38 

NAME: GETNUM 

FUNCTION:: 'Read Number 

STATUS: User 

CALLING SEQUENCE : LDX P 

LDB R 
BRS 38 

F = Pile number 
R = Radix 

DESCRIPTION: Inputs an Integer to any radix. The num- 
ber may be preceded by a plus or minus sign. On exit 
the number will be in the A register. The conversion 
is terminated by any non-numeric character which will 
be in the B register on exit. The number is computed 
by multiplying the number obtained at each stage by the 
radix and adding the new digit. 

REGISEERS AFFECTED: A/B 


6.1.3 


NUMBER: 52 

NAME: . FPI 

FUNCTION: Formatted Input 

STATUS: User 

CALLING SEQUENCE: 


LDX 

FORMAT 

BRS 

52 

BRU 

X 


DESCRIPTION:. This routine reads characters from a file 
specified in the format work, FORMAT. FORMAT also 
specifies the format of the input. Free form input from 
the teletype results when FORMAT = . A skip return 
is generated if and only if (1) the input is free form, 
and (2) the input is floating point. The internal trans- 
lation of the input file is stored in A^B. 

REGISTERS AFFECTED:- A ;B,X 


6.1.^ 


NUMBER: 53 

NAME: FFO 

FUNCTION: Formatted Output 

STATUS: User 

CALLING SEQUENCE: LDX FORMAT 

BRS 53 

DESCRIPTION: The integer In A. or the double word 

floating; point value in A,B is output to the file ac- 

cording to the file number and format specified in 
FORMAT. 

REGISTERS AFFECTED: None 


6.1.5 


NAME: SIC 

FUNCTION: String to Internal Conversion 

STATUS: User 

CALLING SEQUENCE: LDX FORMAT 

SIC POINTER 

BRU INTEGER 

BRU FLOATING 

DESCRIPTION: See String Processing System documents. 
FORMAT describes the type of conversion to be done. 

The; contents of POINTER point to the character immediately 
preceding the character string. POINTER+1 contains the 
character address of the last character of the string. 

INTEGER and FLOATING are routines that handle the con- 
verted input. Error flags, if applicable, are in the 
index register A, double word value corresponding to 
the string is in A,B upon return. 

REGISTERS AFFECTED: A,B,X 


6.1.6 


NAME-: ISC 

FUNCTION: Converts Internal Numbers to Formatted Out- 
put Strings 

STATUS: User 

CALLING SEQUENCE: 


LDP 

M 

LDX 

FORMAT 

ISC 

POINTER 


DESCRIPTION: See String Processing Documents. FORMAT 
describes the type of conversion to be done. The con- 
tents of POINTER point to the character immediately 
preceding the character string. POINTER+1 contains 
the character address of the character immediately pre- 
ceding the position where the first character of output 
is to go. M,M+1 contain the floating point word to b© 
converted. Pointer+1 is incremented once for each char- 
acter added to the string. 

REGISTERS AFFECTED: A,B,X 


6.2.1 


NUMBER: 50 

NAME: PPIX 

FUNCTION: Conversion from Floating Point to Fixed Point. 

STATUS: User 

CALLING SEQUENCE: BRS 50 

DESCRIPTION: Fixes the double word floating point value 
in (A^B). The integer part is left in A. The fractional 
part is left adjusted "in B. 

REGISTERS AFFECTED: A, B 


6.2.2 


NUMBER: 51' 

NAME: ■ PPLT 

FUNCTION: Conversion from Fixed Point to Floating Point 

STATUS: User 

CALLING SEQUENCE: BRS 51 

DESCRIPTION: The integer in A is converted to a normal- 
ized floating point value in A ,8. 

REGISTERS AFFECTED: A^B' 


6.2.3 


NUMBER: . 21 

NAME: PNA 

FUNCTION: Floating Negate 

STATUS: User 

CALLING SEQUENCE: BRS 21 

DESCRIPTION: The double word floating point value in 
the A and B registers is negated. 

REGISTERS AFFECTED: A, B 


6.2.4 


NAME: FAD 

FUNCTION: Floating Point Addition 

STATUS: User 

CALLING SEQUENCE: FAD N 

DESCRIPTION: SYSPOP FAD (A,B)+(M,M+1) 
A floating: addition is performed to the contents of 
memory location M and M+1 and the A and B registers 
The results are left in the A and B registers. 

REGISTERS AFFECTED: \ A,B . 


6.2.5 


WAME: PSB 

FUNCTION: Floating Point Subtraction 

STATUS: User 

CALLING SEQUENCE : PSB N 

DESCRIPTION: (A,B) - (M,M+1) 

The contents oif memory locations M and M+l are subtracted 
(floating subtraction) from the contents of the A and 
B registers. The results are left in the A and B regis- 
ters . 

REGISTERS AFFECTED: A,B 


6.2.6 


NAME; PMP 

FUNCTION: Floating Point Multiplication 

STATUS": ' User 

CALLING SEQUENCE: FMP M 

DESCRIPTION: (A,B)*(M,M+1) 

The contents of memory locations M and M+1 are multiplied 
(floating multiplication) by the A and B registers and 
the results left in the A and B registers. 

REGISTERS AFFECTED: A,B 


6.2.7 


NAME: FDV 

FUNCTION: Floating Point Divide 

STATUS: User 

CALLING SEQUENCE: FDV M 

DESCRIPTION: (A ,B)/(M ,M+1 ) 

The contents of the A and B registers are divided (float 
ing. divide) by the contents of memory locations M and 
M+1 vjith the quotient left in the A and B registers. 

REGISTERS AFFECTED: A,B 


7.1 
Rev. 8/67 


NUMBER: 95 

NAME: ECDUMP 

FUNCTION: Dump 

STATUS: Exec Only 

CALLING SEQUENCE: LDA N 

BRS 95 

N = File Number 

DESCRIPTION: This BRS writes the entire current state of 
the machine (user's program only) on the specified file, 
which is made type 4. The status of the pseudo-relabeling 
registers and all information necessary to restart the user 
from his current situation are written on the dump file 
so that it can be restored by a recovery procedure. The 
only information not preserved are any shared memory entries 
which may be in the pseudo-relabeling. 

NOTE: Dumps created by one system cannot be recovered by 
another, i.e.. System A to System B since the System Letter 
is placed in the dump file. 

REGISTERS AFFECTED: All 


7.2 
Rev. 8/67 


NUMBER: 96 

NAME : ECRECV 

FUNCTION: Recover 

STATUS : Exec Only 

CALLING SEQUENCE: LDA N 

BRS 96 

N = File Number 

DESCRIPTION: This BRS reads the diimp file written by a 
BRS 95 and recovers the machine status as it appeared at 
the time the dump was taken. The message "NOT COMPATIBLE" 
is typed if the dump file was created on an incompatible 
system. 

REGISTERS AFFECTED: All 


8.1 


NUMBER: 42 

NAME: RREAL 

FUNCTION: Read Real-Time Clock 

STATUS:. User 

CALLING SEQUENCE: BRS H2 

DESCRIPTION: Read the real-time clock in the A register 
Time. is given as a 24 bit binary number representing 
60ths of a second. The clock is set to zero when the 
system is started and it is incremented by one at every 
l/60th second. A binary form of the month, date and 
start-up time is put in B. Prom A and B the user can 
calculate the month, date and time. 

REGISTERS AFFECTED: A,B 


8.2 


NUMBER: 91 

NAME: EXRTIM 

FUNCTION:, Read Date and Time into a String 

STATUS: User 


CALLING SEQUENCE: 

LDA 

S 


LDB 

S+1 


BRS 

91 


S = Beginning string pointer. 
S+1 = Ending string pointer. 

DESCRIPTION: The current date and time are appended 
to the string provided in A and B registers and the 
resulting string pointers are returned in the A and B 
registers. The characters appended to the string have 
the form: 

MM/dd hh:mm 

MM=Month 

dd=Day 

hh=Hours counted from to 2^ 

mm=Minutes 

REGISTERS APPECTED : None 


8.3 


NUMBER: 88 

NAME : RTEX 

FUNCTION: Read Execution Time 

STATUS: System 

CALLING SEQUENCE: BRS 88 

DESCRIPTION: Returns the execution time for the job 
in A. 

REGISTERS AFFECTED: A 


8.4 


NUMBER: 4l 

NAME: lORET 

FUNCTION: Return from I/O Subroutine 

STATUS: User 

CALLING SEQUENCE: BRS 4l 

DESCRIPTION: This is used by the author of an I/O sub- 
routine to return to the calling program. 

REGISTERS AFFECTED: A 


8.5 


NUMBER: 111 

NAME: BRSRET 

FUNCTION: Return from Class 3 BRS 

STATUS: System 

CALLING SEQUENCE: BRS 111 

DESCRIPTION: This BRS is used only, by the author of 

class 3 BRS's. It is the only normal termination of 

a class 3 BRS. It corresponds to a BRS 10 for other 
forks . 

Instruction Trap: 

BRS Issued by a fork which was not a class 3 BRS 

REGISTERS AFFECTED: None 


8.6 


NUMBER: 112 

NAME: TSOPP 

FUNCTION: Turn Off Teletype Station 

STATUS: System 

CALLING SEQUENCE: LDA Job Number 

BRS 112 

DESCRIPTION: This BRS is known as suicide. The 
job disappears completely from the system. 

The teletype line associated with the job will be set 
ready for another job if he merely logged out . 

REGISTERS AFFECTED: All 


8.7 


NUMBER: 71 . 

NAME: SKXEC 

FUNCTION: Skip if System 

STATUS: User 

CALLING SEQUENCE: BRS 71 

DESCRIPTION: The B register is set to the value of the 
use code which the user. has. set for the job. These 
values are: 

Value of B Use Code 

1 Subsystem User 

User 

-1 Both 

—2 System 

The BRS skips if the B register is negative. 

REGISTERS AFFECTED: B 
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NUMBER: BE+5 

NAME: SDBM 

FUNCTION: Set Disc Bit Map . 

STATUS: System 

CALLING SEQUENCE: LDA =Address of X Block Mod H 

BRS BE+5 
EXCEPTION RETURN 
NORMAL RETURN 

Exception Return - A contains address that was in 

conflict . 

DESCRIPTION: Turns off bits in the disc bit map for 
the X block and each data block referenced by the index 
block. If any conflicts occur (the bit is already off), 
the address is left in the A register and the exception 
return is taken. A conflict also increments one of two 
counters, XBERR or PDERR, for errors in the X block or 
the file directory respectively. 

When the bit map has been set, one more call is made 
to this BRS with A negative. At that time a switch is 
set ailiowing output files to be opened; the new overflow 
pointer is set from B and the accounting area pointer 
is set from X . 

REGISTERS AFFECTED: A 
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NUMBER: BE+8 

NAME: CRASH 

FUNCTION: To Crash the System 

STATUS: System 

CALLING SEQUENCE: BRS BE.+8 • 

NO RETURN 

DESCRIPTION: Saves the registers in 5501 ^ 5502, 5503. 
Saves in MCRO . Turns off the clock and disables the 
interrupts. Moves the TS block into real page 7 and 
the current relabeled page into real page 6. 

REGISTERS AFFECTED: .None 
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NUMBER: BE+13 

NAME: SETSW 

FUNCTION: Sets System Exec Switches In SYMS 

STATUS: System 

CALLING SEQUENCE: LDA V 

LDX N 
BRS BE+13 
NORMAL RETURN 

V = New switch value 
N = Switch number 

DESCRIPTION: The switch is set to the new value and 
the old value is returned in A. 

REGISTERS AFFECTED: A 
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NUMBER: 152 

NAME : EXS 

FUNCTION: Execute Instruction in System Mode 

STATUS: System 

CALLING SEQUENCE : EXS . I . • 

I = Address of the instruction to be executed. 

DESCRIPTION: This SYSPOP will cause the instruction 
pointed to by I to be executed in the system mode. 

REGISTERS AFFECTED: Depends on instruction. 
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9.0 INDEX OP BRS'S AND SYSTEM OPERATORS 

9.1 BRS'S 

Open a Pile of a Specific Device 

Close a Pile 

Release a Page of Memory • 

Look up String in Hash Table / 

Insert String in Hash Table 

Close .All Piles 

Open Fork 

Terminates the Calling Pork . 

Clear the Teletype Input Buffer 

Declare Echo Table 

Test Input Buffer for Empty 

Delay Until the TTY Output Buffer 
is Empty 

Read Input Pile Name 

Open Input File in Pile Directory 

Close All Piles 

Read a Pile Name and Look It Up 
in the Pile Directory 

Open Output Pile Located in Pile 
Directory 

Close a File or a Tape File 

Floating Point Negate 

Terminates all Forks Subsidiary 
to the System Exec 

23 3.1.1 Link/Unlink Specified TTY 


1 

2.1 

.1 

2 

2.1 

.3 

M 

M,l 

.1 

5 

5.2 

.1 

6 

5 .2 

.3; 

8 

2.1, 

.5 

9 

.1.3 

.1 

10 

1.6, 

.1 

11 

3.2, 

■1 

12 

3.2, 

.3 

13 

3.2, 

.5 

Ik 

3.2, 

.6 

-15 

2.2, 

.1 

'ne 

2.2, 

.2 

•n? 

2.2, 

.3 

^18 

2.2, 

.k 

»19 

2.2. 

.5 

•Jf20 

2.1. 

J\ 

21 

6.2. 

.3 

22 

1 . 6 . 

.2 
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24 3.1.2 Unlink All TTY»s 

25 3.1.3 Set Teletype to Accept/Refuse Links 

26 1.2. it . Skip if Escape Waiting 

27 3.1.4 Attach TTY to Calling Program 

28 3.1.5 Release Attached TTY 

29 3.2.2 Clear the Output Buffer 

30 1.4.1 Read Status of a Lower Pork 

31 1.5.4 Wait for Specific Pork to Cause 

a Panic 

32 1.6.3 Terminates a Specified Lower Fork 

33 5.1.1 Read String 

34 5.1.2 Output Message 
. 35 5.1.3 Output String 

36 6.1.1 Output Number to Specified Radix 

37 5.2.2 General String Look Up 

38 6.1.2 Input Number to Specified Radix 

40 3.2.4 Read Echo Table 

41 8.4 Return. from I/O Subroutine 

42 8.1 Read Real-Time Clock 

43 4.1.4 Read Pseudo Relabeling 

44 4.1.5 Set Pseudo Relabeling 

45 1.5.1 Dismiss on Quantum Overflow 

46 1.2.2 Turn Escape Off 

47 1.2.3 Turn Escape On 

*48 2.2.6 Look Up Input/Output Pile Name 
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^9 1.1.3 Read Interrupts .Armed 

50 6.2.1 Conversion from Floating Point to 

Fixed Point 

51 6.2.2 Conversion from Fixed Point to 

Floating Point 

52 6.1.3 Formatted Floating Point Input 

53 6.1.4 Formatted Floating Point Output 
56 4.1.9 Make Page System 

57. 1.3.2 Guarantee l6ms Computing 

»60 2.2.7. Look up I/O File Name and Insert 
in Pile Directory if not Found 

66 2.1.6 Delete DSU Pile Data 

67 2.1.7 Delete DSU File Index Block 

68 4,2.1 Make Pseudo-Page Shareable 

69 4.2.2 Get SMT Block to PMT 

72 1.5.2 System Dismissal 

73 1.6.4 Terminates a Specified Number of 

Lower Forks 

78 1.1.1 Arm/Disarm Software Interrupts 

79 1.1.2 Cause Specified Software Interrupts 

80 4.1.10 Make Page Read Only 

81 1.5.3 Dismiss for Specified Amount of 

Time 

82 2.1.8 Switch Sequential File Type 

85 3.2.7 Set Special TTY Output 

86 3.2.8 Clear Special TTY Output 

87 2.1.9 Read DSU File Index Block 
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88 8.3 Read Execution Time 

90 1.2.1 Declare a Pork for Escape 

91 8.2 Read Date and Time into a String 

^95 7.1 Dump Program and Status on Pile 

•*96 7.2 Recover Program and Status from 
Pile 

10^ 2.1.10 Read a Page (2048 words) from RAD 

105 2.1.11 Write a Page (2048 words) to RAD 

106 1.5.5 . V/ait for Any Pork to Terminate 

107 1.4.2 Read Status of all Lower Porks 

108 1.6.5 Terminate All Lower Porks 

109 1.5.6 Dismiss Calling Pork 

110 2.1.2 Read Device and Unit 

111 8.5 Return from Exec BRS (Exec Only) 

112 8.6 Turn Off Teletype Station (Exec Only) 

113 2.1.12 Compute Pile Size of a Disc Pile 

114 2.1.13 Turn Off Run-Away Magnetic Tape 

116 4.1.6 Read User Relabeling 

117 4.1.7 Set User Relabeling 

118 2.1.14 Allocate Magnetic Tape Unit 

119 2.1.15 De-Allocate Magnetic Tape Unit 

120 4.3.3 Acquire a New Page 

121 4.1.2 Release Specified Page from PMT 

122 4.1.8 Simulate Memory Panic 
BE+l 2.1.19 Read DSU 

BE+2 2.1.20 Write DSU 
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BE+3 3.1.6 Test for Carrier Present 

BE+^ ^.1.11 Read/Write One Word In the Monitor. 

BE+5 8.8 Set Disc Bit Map 

BE+6 3.1.7 Turn a Teletype Line On or Off 

BE+7 2.1.18 Test a Breakpoint Switch 

BE+8 8.9 To Crash the System for Error 
Diagnostic 

BE+9 2.1.16 Read DSU Pap;e 

BE+10 2.1.17 Write DSU Page 

BE+11 3.2.9 Ignore Line Feed or Carriage Return 
When Followed by Carriage Return 
or Line Feed Respectively 

BE+12 1.1.^ Arm Timing Interrupt 

BE+13 8.10 Sets System Exec Switches in SYMS 

BE+14 5.1.^ Input String with Edit 
9.2 SYSTEM OPERATORS 

BIO 2.3.2 Block Input/Output 

Character Input/Output 

Character Input and Test 

Input/Output Control 

Execute Instruction in System Mode 

Floating Point. Addition 

Floating Point Division 

Floating Point Multiplication 

Floating Point Subtract 

G e t C h a r • a c t e r' fro ni f-: n d o C Str 1 n f 'i 
and Decrement End Pointer 


CIO 

2.3.1 

CIT 

5.1.5 

CTRL 

2.3.^ 

EXS 

8.11 

PAD 

6.2.^ 

PDV 

6.2.7 

FMP 

6.2.6 

FSB 

G.2.5 

GCD 

5 . ^1 . 3 
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GCI 5.^.1 Get Character from Beginning of 

String and Increment Beginning Pointer 

ISC 6.1.6 Internal to String Conversion 

1ST 3.2.12 Input from Specific TTY 

LDP 5.3.2 Load String Pointer 

OST 3.2.13 Output, to Specific TTY. 

SKSE 6.3.3 Skip if .String Equal 

SKSG 5.3.^ Skip if String Greater 

SIC 6.1.5 String to Internal Conversion 

STI 3.2.1^1 Simulate TTY Input 

STP 5.3.1 Store String Pointer 

TCI 3.2.10 Teletype Character Input 

TCO 3.2.11 Teletype Character Output 

V/CD 5.^.^ Put Character on Beginning of String 
and Decrement Beginning Pointer 

WCH 5.^.5 Write Character to Memory by Table 

VJCI 5.^.2 Put Character on End of String and 
Increment End Pointer 

WIO 2.3.2 Word Input/Output 

Those BRS's marked with an asterisk are executive BRS's 

and all others are monitor BRS's. 
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10.0 APPENDIX A, GLOSSARY OF TERMS 

BE = 123 

This is the symbolic name given to the last BRS devel- 
oped by Berkeley and used by Tymshare. All "BE" BRS's 
were developed by Tymshare and are addressed relative 
to those developed' by Berkeley in order to later in- 
clude other desirable Berkeley developed BRS's. 

BREAKPOINT SWITCH 

Refers to the four toggle switches physically located . 
on the computer console . 

COMMAND FILE 

The particular file from which the commands to the 
System Executive and Subsystems are input. For tele- 
type input the command file number is zero. 

CUSTOMER FILE DIRECTORY 

The names of all files for a particular user are re- 
corded in this directory. 

DEVICE TABLE 

Device Number 

Paper Tape Input I 

Paper Tape Output 2 

Magnetic Tape Input 4 

Magnetic Tape Output 5 

Hollerith Card Output 6 

Binary Card Output 7 
High Speed Printer Output 11 

Hollerith Card Input 12 

Binary Card Input 13 

DSU BLOCK 

Four consecutive sectors on the disc whose beginning 
addresses are MOD 4. A block consists of 256 words. 

DSU DATA BLOCK , 

A DSU block with pointers in the first and second words. 
The first word points to the first relevant data word. 
The second word points to the last relevant data word. 

DSU FILE 

A file stored on the Disc Storage Unit. Each file 

consists of at least an Index Block and if the file 

contains data, then a sufficient number of DSU blocks 
to record the data. 
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PILE NUMBER 


A file number is assigned by the system to files 
as they ai'e opened. Also, there are fixed file 
numbers for certain devices. These are as follows: 

. Teletype Input 

1 Teletype Output 

2 Nothing . 


PILE TYPE 


There are four standard file types . 
follows : 


They are. as 


Pile written by the System Executive as 
commanded by. the "SAVE" command. 

General Binary File created by a sub- 
system, i.e. 3 a. FORTRAN Object Program. 

Symbolic Pile 

Dump Pile 


PORK 


A fork is all or part of a program. A program may 
consist of iriany forks and these forks may be in 
a heirarchy one to another. Porks are different 
from subroutines in that all forks making up a prog- 
ram could be theoretically executing simultaneously. 
At least one fork is associated with each active 
user in the system. 


PORK STATES 

-2 
-1 



1 

2 

INDEX BLOCK 


Dismissed for I/O. 

Running. 

Dismissed on escape key or programmed panic 

Dismissed on illegal instruction panic . 

Dismissed on memory panic. 


A DSU Block (256 words) which contains the DSU ad- 
dresses for all data blocks of a file. Words 
through 120 contain a DSU address which is MOD ^1 
in bitr. 6 to 23. B:lts and 5 of these words arc 
unused. Bit 2 indicates an End of Recoi'd data block 
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INDEX BLOCK (cont . ) 

VJords 121 and 122 are link pointers and 123 is a 
hash total. Words 12^ through .130 contain the file 
name and word 131 contains user numbers. 

PAC TABLE 

Each fork is defined by a program active table. 
This table contains most of the information 
required to control selection, execution and in- 
terruption of the fork (additional information is 
stored in the users TS page). 


PAGE 


A page can exist on RAD, DSU or in-core memory but 
in all cases refers to 20^8 words. 


PANIC 

A panic is a signal to the system to break execution 
of a fork. 

PANIC, INSTRUCTION 

A panic caused by attempting to execute an instruc- 
tion which cannot be executed in the user mode, 
such as a halt or device I/O instruction or a BRS 
which is not available to the user. 

PANIC,: MEMORY 

A panic caused by a fork attempting to address 
memory outside its range or write on memory which 
is set to read only. 

PANIC TABLE 

Word 

= Program Counter 

1 - A Register 
2- B Register 

3 = X Register 

4 = First Relabeling Register 

5 = Second Relabeling Register 

6 = Status 
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PANIC TABLE (cont. ) 

The status word may be: 

-2 Dismissed for Input/Output 

-1 Running 

Dismissed on Escape or BRS 10 

1 Dismissed on Illegal Instruction Panic 
. 2 Dismissed on Memory Panic 

A Panic Table must not. overlap a page boundary. 

QUANTUM, LONG TIME 

The maximum length of time a fork can run before 
the schedule checks for other forks to be run. 

QUANTUM, SHORT TIME 

The minimum length of time a fork will run before 
the scheduler checks for other forks to be run which 
were dismissed for I/O. 

RELABELING, PSEUDO 

See Relabeling Registers 

RELABELING REGISTERS 

The relabeling registers are used to indicate a 
page number v/hich has been assigned to a user for 
a particular logical page. They are of the form: 


First Word [Page | Page 1 | Page 2 | Page 3 


Second Word fP age U | PagcF 3 "| Page 6 | Pagei 7~1 

STRING POIMTI'RS 

A pair of pointers which contain a character addresn 
of t)ie character before the first: character of a 
string and a character address of the last character 
of the string. 

STRING, NULL 

A pair of string pointers whose character addresses 
are the same . 


